Si vous souhaitez contribuer, vous trouverez ci-dessous quelques indications pour démarrer
Les liens
-
Le site Web
📎 brutdethé.fr -
Pour suivre le travail effectué et les choses qu’on aimerait faire :
📎 Liste des tâches -
Le site De l’API-tea
📎 api-tea.brutdethé.fr
Liens pour contribuer
-
L’adresse du dépôt Github (où se trouve le code source) et le contenu des articles :
📎 https://github.com/brutdethe/site -
Le contenu des articles de la ressources :
📎 https://github.com/brutdethe/site/tree/master/content -
API-tea : L’adresse du dépôt Github où se trouve les data sur les thés :
📎 github.com/brutdethe/api-tea -
API-tea : L’adresse des fichiers pour contribuer sur les thés :
📎 github.com/brutdethe/api-tea/data/yaml
Comment corriger une erreur ou modifier un thé ?
Par exemple, pour modifier une origine ou un cultivar qui ne correspond pas
Il faut rejoindre le fichier qui contient les thés :
📎 brutdethe/api-tea - /data/yaml/teas.yaml
On commence par cliquer sur le stylo :
On fait les modifications et en bas de la page on renseigne un message de commit pour expliquer les modifications - par exemple :
ajoute la ville et la province pour le Anxi TieGuanYin
Puis on clique sur le bouton vert : Commit Change
Ajouter un nouveau thé ?
Il faut rejoindre le fichier qui contient les thés :
📎 brutdethe/api-tea - /data/yaml/teas.yaml
On peut copier/coller un thé existant et changer les données (comme modèle vous pouvez prendre : 安溪鐵觀音 qui est pour l’instant le plus complété)
Pour mieux comprendre, chaque thé comporte des rubriques qui sont formatées comme suit :
- zn: <idéogramme non-simplifié>
province: <province>
town: <ville(s)>
elevation: <altitude(s)>
temperature: <température(s) d'infusion recommandée>
fermentation: <pourçentage de fermentation>
cultivar: <cultivar(s)>
harvest: <season(s)>
picking: <type(s) de ceuillette>
brewing:
- type: <type d'infusion>
quantity: <quantité>
duration: <durée d'infusion en seconde>
times: <nombre d'infusion>
Les espaces utilisés pour formater sont important, c’est eux qui structurent les données.
Pour écrire un article
---
title: <le titre>
description: >
<une petite description>
---
L'article commence ici